# $OpenBSD: README,v 1.6 2015/12/14 07:01:04 sebastia Exp $

+-----------------------------------------------------------------------
| Running ${FULLPKGNAME} on OpenBSD
+-----------------------------------------------------------------------

The OpenGroupware system user
=============================

The system user and group intended to run the OpenGroupware application server
is called _opengroupware. The users home directory is ${VARBASE}/opengroupware.

OpenGroupware with apache-httpd
===============================

OpenGroupware requires the mod_ngobjweb module used with Apache2. The one
that comes with the OpenGroupware package is built against apache-httpd
package.

Per default the web server runs in a chroot environment. Therefore you have to
copy some files into the server's chroot environment:

# mkdir -p ${VARBASE}/www/htdocs/OpenGroupware55.woa
# cp -R ${TRUEPREFIX}/share/opengroupware/www \
	${VARBASE}/www/htdocs/OpenGroupware55.woa/WebServerResources

The web server needs the ngobjweb Apache module loaded. The following line
need to be added to ${SYSCONFDIR}/apache2/httpd2.conf:

LoadModule ngobjweb_module ${PREFIX}/lib/apache2/ngobjweb_module.so

A sample configuration is installed as example
# cp ${TRUEPREFIX}/share/examples/opengroupware/opengroupware.conf ${SYSCONFDIR}/etc/apache2/extra

Enable the loading of that file in ${SYSCONFDIR}/apache2/httpd2.conf:
Include ${SYSCONFDIR}/extra/opengroupware.conf

Then restart apache to make the changes effective
# rcctl restart apache2

OpenGroupware configuration example
===================================

Example configuration files for a simple setup are installed with the package.
In order to use them, copy the files as user _opengroupware
to the users Defaults directory:

$ cp ${TRUEPREFIX}/share/examples/opengroupware/*.plist ~/GNUstep/Defaults/

The example assumes you have all the services necessary to run OpenGroupware
on the localhost. These are an LDAP server, an IMAP server, and a PostgreSQL
database.

You can edit the OpenGroupware configuration files manually with your
favourite text editor, but doing so is discouraged. Better use the GNUstep
defaults(1) tool. See the manual page for advice how to use it.

Initializing the database
=========================

Change to the _postgresql user, and create the database:

# su - _postgresql
$ createuser _opengroupware
$ createdb -O _opengroupware -E UTF-8 -t template0 opengroupware
$ psql -U _opengroupware opengroupware < \
	${TRUEPREFIX}/lib/opengroupware/commands/OGo.model/Resources/pg-build-schema.psql

You may have to edit the pg_hba.conf to grant access for the
_opengroupware user.
